home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / comm / bug13.zip / BUG.DOC < prev    next >
Text File  |  1992-03-20  |  11KB  |  371 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                          BUG : "3k BYTES COMM PROGRAM"
  19.                          =============================
  20.                               (v 1.3 01-Feb-1992)
  21.                                       by
  22.                               Maurizio  Ammannato
  23.  
  24.  
  25.  
  26.  
  27.  
  28. HAPPYWARE CONCEPT
  29. =================
  30. My  personal  concept of HAPPYWARE is to deliver a fully working package at $0
  31. licence  fee  to  enjoy together this fantastic opportunity to share ideas and
  32. knowledge over physical, cultural, race and religious boundaries.
  33.  
  34.  
  35. Use  it as you want, but don't make any kind of profit on my work which you've
  36. received free of charge.
  37.  
  38.  
  39.  
  40.  
  41.  
  42. MY PREFERRED SENTENCE
  43. =====================
  44. "Nothing  is  better than to remain honest and integer. Nothing is better than
  45. to  fix  one's eyes without casting down owns. But you must be prepared to pay
  46. an high price for that."                                 (Oiziruam Otannamma)
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                                                     Maurizio Ammannato
  76.                                                     Via Preguda N.60
  77.                                                     22049 Valmadrera (CO)
  78.                                                     I T A L Y
  79.                                                     ---------------------
  80.                                                     (tel. 39-341-581081)
  81.  
  82.  
  83.  
  84.  
  85.  
  86.                               ==================
  87.                               BUG.COM 3468 bytes
  88.                               ==================
  89.  
  90. WHY BUG
  91. =======
  92. BUG  is  a  very  compact program but with all the vital features for an usual
  93. communication  package.  I  made  it to demonstrate that is possible to have a
  94. working communication program without generating elephantine code.
  95.  
  96. I  can  claim  that BUG is the smallest asynchronous communication program for
  97. MS-DOS in the world, but I'm expecting to be denied!
  98.  
  99.  
  100.  
  101.  
  102. EXECUTING BUG
  103. =============
  104. BUG  uses FOSSIL drivers, version 5 and later. BUG has been extensively tested
  105. with  X00  driver  version  1.24.  You can find this driver on public BBS like
  106. GEnie   (X00V12.ZIP).   See  below  for  more  details  on  the  use  of  this
  107. communication driver.
  108.  
  109.  
  110. To  execute  BUG you must have just installed the FOSSIL driver, then you have
  111. to use the command line format as following :
  112.  
  113.  
  114.                     ======================================
  115.                     BUG Port Speed Bits Parity [INPutFile]
  116.                     ======================================
  117.  
  118.  
  119. - "Port"     : communication port number (1 or 2)
  120. - "Speed"    : port speed (from 1200 bps up to 9600 bps, no 300 bps)
  121. - "Bits"     : number of bits (7 or 8). STOP bit/s are set up automatically
  122. - "Parity"   : E for Even, O for Odd or N for None
  123. - "INPutFile": optional name for Input File (default = BUG.INP)
  124.  
  125.  
  126.               ===================================================
  127.               ALL PARAMETERS ARE MANDATORY EXCEPT FOR "INPutFile"
  128.               ===================================================
  129.  
  130.  
  131. C>BUG 1 2400 7 E          BUG at 2400 bps parity Even from port 1, bit 7
  132. C>BUG 2 9600 8 N          BUG at 9600 bps parity None from port 2, bits 8
  133. C>BUG 1 4800 7 E A.INP    BUG using the file A.INP as Input File, bits 7
  134.  
  135.  
  136. You  can  use  more  .BAT files with different BUG command lines for different
  137. communication needs.
  138.  
  139.  
  140.  
  141.  
  142.  
  143. BUG ALIVE
  144. =========
  145. Once  executed  you  get  a 24 lines screen plus the 25th with the list of the
  146. commands you can use.
  147.  
  148.  
  149.  
  150. - F1   Printer ON/OFF (when ON you see a "P" in the middle of the 25th)
  151.        Default=OFF
  152.  
  153. - F2   Capture file ON/OFF (when ON you see a "C". Display or print BUG.CAP
  154.        file after the connection to get all comm session). Default=ON
  155.  
  156. - F3   Flow ON/OFF (when ON you see an "F". Remember to set the flow control
  157.        also on host: expecially useful while printing long documents on-line)
  158.        Default=OFF
  159.  
  160. - F4   ASCII file upload (any key to escape)
  161.  
  162. - F5   Shell to DOS (driver is temporarily deinizialized so that you can
  163.        execute from DOS also programs using the same port. Type EXIT to come
  164.        back to BUG)
  165.  
  166. - F6   Read next string from input BUG.INP file and send it to modem/host
  167.        (see below)
  168.  
  169. - F7   Send a true break to the host
  170.  
  171. - F8   Execute S.BAT file and come back to BUG at its end ( That is very
  172.        useful to upload files to host using external protocols like XMODEM or
  173.        KERMIT or ZMODEM; it's up to you to structure S.BAT file for your
  174.        needs.)
  175.  
  176. - F9   Execute R.BAT file and come back to BUG at its end ( That is very
  177.        useful to download files from host using external protocols like
  178.        XMODEM or KERMIT or ZMODEM; it's up to you to structure R.BAT file for
  179.        your needs.)
  180.  
  181. - F10  To exit to DOS
  182.  
  183. - Alt-J for Jolly. Pressing together both these keys, BUG executes J.BAT
  184.   batch file. You can use this J.BAT file as a Jolly;to execute another Error
  185.   Free Protocol, or to execute a local Editor to modify a file before
  186.   uploading it, etc. or finally to be able to come back to the beginning of a
  187.   connection and navigate all the working session. To do that, prepare the
  188.   following jolly J.BAT batch file:
  189.  
  190.   @echo off
  191.   list bug.cap (or any listing program you have)
  192.  
  193.   That's all. Now each time you press Alt-J keys, you get all comm session
  194.   from the beginning.
  195.  
  196.  
  197.  
  198.  
  199.  
  200. SCRIPT FILE
  201. ===========
  202. In  reality  BUG uses a pseudo script capability.  To use this powerful option
  203. build  with  your  preferred  text editor the file BUG.INP. Write on each line
  204. the string you want to send to modem/host at a specific time.
  205.  
  206. Let  me  image  you  want  to  initialize  the  modem,  call host number, send
  207. password  and finally set some communication parameters. Edit BUG.INP file and
  208. write the following lines :
  209.  
  210.  
  211. ~ATZ                      wait .2 sec, then send reset modem string
  212. ATE0%C1\N3....            set modem for reliable
  213. ATDP1616161616            call host
  214. xjm12345,pippo            send User Number and User Password
  215. set fn                    set flow control ON, on the host side
  216. set c[char]               set decimal 8 as cancel character (backspace)
  217.  
  218.  
  219. Once  executed  BUG  via  GO.BAT  file, press firstly the F6 functional key to
  220. allow BUG to read the first BUG.INP line and to send it to modem.
  221.  
  222. Wait  for  the  modem "OK", then press again F6 key for the second line and so
  223. forth.  For  each F6 use, BUG reads and sends the next line in BUG.INP file up
  224. to  its  end.  F6  key is inactive if BUG doesn't find any BUG.INP file or has
  225. reached the end.
  226.  
  227. You  can  use many .INP files with different commands. For example "BUG 1 2400
  228. 7  E  GENIE.INP"  can  be specialized for downloading from GEnie Service using
  229. the following script :
  230.  
  231. ~ATZ...
  232. ATDP1616161616
  233. xjm12345,pippo
  234. move 615;3
  235. 6
  236.  
  237.  
  238.  
  239.  
  240. INITIALIZING X00 FOSSIL DRIVE
  241. =============================
  242. You  can  use  any FOSSIL drive you want. Any way BUG has been tested with X00
  243. driver. Follow this simple procedure to quickly work with BUG.
  244.  
  245.  
  246. 1) Download X00V12.ZIP shareware file from your preferred BBS
  247. 2) Decompress it as appropriate (i.e. C:>PKUNZIP X00V12)
  248. 3) Take only X00.SYS file and copy it into BUG directory
  249. 4) Rename X00.SYS to X00.EXE
  250. 5) Execute GO.BAT (in my package)
  251.  
  252.  
  253.  
  254.  
  255.  
  256. GO.BAT FILE
  257. ===========
  258. My  GO.BAT  file  loads X00 driver with 4096 bytes for the Receive comm buffer
  259. and  1024 for the Transmit comm buffer, then executes BUG, finally deallocates
  260. X00 from the main memory. GO.BAT file looks like :
  261.  
  262.  
  263. @echo off
  264. X00>NUL R=4096 T=1024 E              allocate X00 driver
  265. BUG 1 2400 7 E                       execute BUG port 1,2400 bps,7 bits,Even
  266. X00>NUL                              deallocate X00 driver
  267.  
  268.  
  269. Modify  GO.BAT  communication  parameters  (both  BUG  and  X00)  if  you have
  270. different  needs.  If instead you prefer to have X00 driver always loaded, put
  271. X00.SYS  into  main  root  directory  (where  the  other .SYS are) and add the
  272. following line to CONFIG.SYS file :
  273.  
  274. DEVICE=X00.SYS R=4096 T=1024 E
  275.  
  276. In this case remove from GO.BAT file the two lines regarding X00 driver.
  277.  
  278.  
  279.  
  280.  
  281. FILES IN THE PACKAGE
  282. ====================
  283. You have to find:
  284.  
  285. - BUG.COM                 Main program
  286. - BUG.DOC                 This file
  287. - BUG.INP                 sample BUG input file (to be used via F6 key)
  288. - GO.BAT                  Batch file loading driver and executing BUG
  289. - R.BAT                   Receive .BAT file (executed by BUG with F9 key)
  290. - S.BAT                   Send .BAT file (executed by BUG with F8 key)
  291. - J.BAT                   Jolly .BAT file (Alt-J for its execution)
  292.  
  293. - LIST.COM                Handy utility to display BUG.CAP file
  294. - LIST.DOC                Its documentation
  295.  
  296.  
  297.  
  298. This  R.BAT  file uses GSZ program and ZMODEM protocol to download a file from
  299. the  host  while  S.BAT uses GSZ program and XMODEM to upload a file to remote
  300. host.
  301.  
  302. But  you  can  use  any external protocol you prefer, just change the name and
  303. related parameters in the R.BAT and S.BAT batch files.
  304.  
  305.  
  306.  
  307.  
  308.  
  309. CHARACTERS
  310. ==========
  311. BUG  accepts  from  the keyboard any type of character from decimal 000 to 255
  312. except  for  extended  codes. For decimal 8  (backspace) BUG correctly makes a
  313. disruptive  backspace  on the screen while sending a decimal 8 to remote host;
  314. be sure that remote host understands dec 8 as a cancel character.
  315.  
  316. From  Host BUG treats characters from decimal 32 up to decimal 255. Characters
  317. from dec 000 up to dec 32 and dec 127 are stripped.
  318.  
  319.  
  320.  
  321.  
  322. CAVEATS
  323. =======
  324. . BUG expects the COMMAND.COM path as FIRST line in the environment table
  325.   exactly with the following FORMAT (as it must be usually) :
  326.  
  327.                           COMSPEC=C:\....\COMMAND.COM
  328.  
  329.  
  330. . BUG before printing checks for printer N. 1 (LPT1:) only.
  331.  
  332. . BUG upload ASCII files with a maximum line length of 80 characters.
  333.  
  334.  
  335.  
  336.  
  337. SECURITY
  338. ========
  339. BUG.EXE  has been verified with SCAN utility v 86. No virus has been reported.
  340. Any  way  verify  BUG.EXE  size (must be as declared at the beginning) because
  341. any  increase  in  the  number of program bytes, is the first symptom of virus
  342. presence (others can infect BUG, then distribute it as a Trojan horse).
  343.  
  344.  
  345.  
  346.  
  347.  
  348. CURIOSITY
  349. =========
  350. For  curious ones, to get BUG.COM so small, I didn't use C, neither ASSEMBLER,
  351. neither  FORTRAN, neither BASIC, neither COBOL, neither PASCAL, neither object
  352. oriented, neither...
  353.  
  354.  
  355.  
  356.  
  357.  
  358. HISTORY
  359. =======
  360.  
  361.        1.0    . First version.
  362.  
  363.        1.1    . The name of the Input File is no more fixed. Use BUG command
  364.                 line format with the new INPut file name at the end.
  365.               . If the PRINTER is not ready, BUG waits some seconds then beep
  366.                 and doesn't allow printing.
  367.  
  368.        1.3    . Added ASCII file upload.
  369.               . Added screen border for color displays.
  370.               . Fixed a bug on 25th line.
  371.